<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-us" xml:lang="en-us">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<meta name="copyright" content="(C) Copyright 2005">
<meta name="DC.rights.owner" content="(C) Copyright 2005">
<meta name="DC.Type" content="topic">
<meta name="DC.Title" content="Using DITA transforms">
<meta name="abstract" content="The core transforms of the DITA Toolkit represent the Reference Implementation for processing the standard DITA specification as maintained by OASIS Open.">
<meta name="description" content="The core transforms of the DITA Toolkit represent the Reference Implementation for processing the standard DITA specification as maintained by OASIS Open.">
<meta name="DC.Relation" scheme="URI" content="DITA-readme.html">
<meta name="DC.Relation" scheme="URI" content="DITA-relnotes.html">
<meta name="DC.Relation" scheme="URI" content="DITA-changes.html">
<meta name="DC.Relation" scheme="URI" content="DITA-futures.html">
<meta name="DC.Relation" scheme="URI" content="DITA-tested.html">
<meta name="DC.Relation" scheme="URI" content="DITA-ant.html">
<meta name="DC.Relation" scheme="URI" content="DITA-javacmd.html">
<meta name="DC.Relation" scheme="URI" content="DITA-log.html">
<meta name="DC.Relation" scheme="URI" content="DITA-h2d.html">
<meta name="DC.Relation" scheme="URI" content="dita2word.html#dita2word">
<meta name="DC.Relation" scheme="URI" content="DITA-limitations.html">
<meta name="DC.Relation" scheme="URI" content="DITA-troubleshooting.html">
<meta name="DC.Format" content="XHTML">
<meta name="DC.Identifier" content="ditausingxform">
<meta name="DC.Language" content="en-us">
<link rel="stylesheet" type="text/css" href="commonltr.css">
<title>Using DITA transforms</title>
</head>
<body id="ditausingxform"><a name="ditausingxform"><!-- --></a>


  <h1 class="topictitle1">Using DITA transforms</h1>

  
  <div><p>The core transforms of the DITA Toolkit represent the <span class="q">"Reference 
    Implementation"</span> for processing the standard DITA specification as 
    maintained by OASIS Open.</p>

    <div class="section" id="ditausingxform__preprocess"><a name="ditausingxform__preprocess"><!-- --></a><h2 class="sectiontitle">Pre-process</h2>
      
      
      <p>A pre-process is done before the main transformation. The input of 
        Pre-process is dita files and the output of Pre-process is also dita 
        files. But the output is in temp directory. Pre-process is the basic 
        for the main transformation, it handles several different processing 
        before the main transformation. Without pre-process, dita topics and 
        map can still be transformed into different outputs, but the features 
        in pre-process such as resolving conref attribute are not available.</p>

    </div>

    <div class="section"><h2 class="sectiontitle">Available core transforms</h2>
      
      <div class="p">A core DITA transform is the basic set of templates that support all 
        the elements of a topic. This set is the basis for the following 
        processing of any specialized element. Core transforms handle one topic 
        instance, or nested set of topics, at a time. The DITA Toolkit provides 
        these core transforms:<dl> <dt class="dlterm">dita2xhtml.xsl</dt>
 <dd>DITA 
        topic to HTML page transform.</dd>
 </dl>
<dl> 
        <dt class="dlterm">dita2fo-shell.xsl</dt>
 <dd>DITA topic to XSL Formatting Object page 
        transform.</dd>
 </dl>
</div>

    </div>

    <div class="section"><h2 class="sectiontitle">Available special output formats</h2>
      
      <div class="p">Additional map-driven tools support transforming sets of topics into 
        special output formats, including:<dl> <dt class="dlterm">Web page 
        (map2htmtoc.xsl)</dt>
 <dd>This transform generates a set of web pages 
        with an index page that is ready to place on a Web site.</dd>
 
         <dt class="dlterm">map2htmlhelp (map2hhc.xsl map2hhp.xsl)</dt>
 
        <dd>This transform generates hhc and hhp file for the compilation of 
        Html Help.</dd>
  <dt class="dlterm">map2javahelp 
        (map2JavaHelpToc.xsl map2JavaHelpMap.xsl)</dt>
 <dd>This transform 
        generates table of content and jhm file for Java Help.</dd>
 
         <dt class="dlterm">map2eclipsehelp (map2elipse.xsl)</dt>
 <dd>This 
        transform generates table of content for help contents in Eclipse.</dd>
 
         <dt class="dlterm">map2printout</dt>
 <dd>Calls topicmerge to 
        consolidate a set of topics into a single entity that is transformed 
        into Formatting Objects (FO), which can be compiled into PDF.</dd>
 
        </dl>
</div>

    </div>

    <div class="section"><h2 class="sectiontitle">Invoke the complete transformation</h2>
      
      <p>The complete transformation including pre-process can be excuted by 
        the ant script. There are some examples of simple ant script in 
        directory /ant. The ant target for the transformation which can be 
        called is listed at <a href="DITA-antuse.html" title="After setting up the Ant environment, you can build the DITA output by running ant command.">Running 
        Ant</a></p>

    </div>

    <div class="section"></div>

  </div>

<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="DITA-readme.html" title="The DITA Open Toolkit is a reference implementation of the OASIS DITA Technical Committee's specification for DITA DTDs and Schemas. The Toolkit transforms DITA content (maps and topics) into deliverable formats, including: XHTML, Eclipse Help, HTML Help, and JavaHelp.">DITA Open Toolkit</a></div>
</div>
<div class="relinfo relconcepts"><strong>Related concepts</strong><br>
<div><a href="DITA-futures.html" title="Activity on the DITA Open Toolkit project will revolve around maintenance (bug fixes), enhancements (new function based on prioritized requests), demos and experimentation (sandbox activity), and community support (forums, etc.).">DITA futures</a></div>
<div><a href="DITA-ant.html" title="Ant is an open tool that uses the DITA processes to make producing DITA output easier.">Building DITA output with Ant</a></div>
<div><a href="DITA-javacmd.html" title="The DITA Open Toolkit release 1.0.2 or above provides a command line interface as an alternative for users with little knowledge of Ant to use the toolkit easily.">Building DITA output with Java command line</a></div>
<div><a href="DITA-h2d.html">Migrating HTML to DITA</a></div>
<div><a href="dita2word.html#dita2word">DITA to Word output transform</a></div>
</div>
<div class="relinfo relref"><strong>Related reference</strong><br>
<div><a href="DITA-relnotes.html">DITA release notes</a></div>
<div><a href="DITA-log.html">Problem determination and log analysis</a></div>
<div><a href="DITA-limitations.html" title="Below are some known limitations categoried by module within the current release of the DITA Open Toolkit.">Known Limitations</a></div>
<div><a href="DITA-troubleshooting.html" title="This section is used for identifying problems when installing and executing the DITA Open Toolkit.">Troubleshooting</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br>
<div><a href="DITA-changes.html" title="This document lists major changes and new features by release.">DITA release history</a></div>
<div><a href="DITA-tested.html" title="See which tools and platforms have been used in testing the DITA processing system.">Tested platforms and tools</a></div>
</div>
</div>

</body>
</html>